package com.jl15988.simpletools.appcore.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.jl15988.simpletools.appcore.dto.ReviewDTO;
import com.jl15988.simpletools.appcore.dto.ReviewRequestDTO;

/**
 * 评论服务接口
 *
 * @author jl15988
 */
public interface ReviewService {

    /**
     * 分页查询应用评论
     *
     * @param appId 应用ID
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 分页结果
     */
    IPage<ReviewDTO> getReviewPage(Long appId, Integer pageNum, Integer pageSize);

    /**
     * 创建评论
     *
     * @param request 评论请求DTO
     * @param userId 用户ID
     * @param username 用户名
     * @return 评论ID
     */
    Long createReview(ReviewRequestDTO request, Long userId, String username);

    /**
     * 更新评论
     *
     * @param request 评论请求DTO
     * @param userId 用户ID
     * @return 是否成功
     */
    boolean updateReview(ReviewRequestDTO request, Long userId);

    /**
     * 删除评论
     *
     * @param id 评论ID
     * @param userId 用户ID
     * @return 是否成功
     */
    boolean deleteReview(Long id, Long userId);

    /**
     * 获取应用平均评分
     *
     * @param appId 应用ID
     * @return 平均评分
     */
    double getAverageRating(Long appId);
} 